package cn.iocoder.yudao.module.wine.service.uservisitor;

import java.util.*;
import javax.validation.*;

import cn.iocoder.yudao.module.wine.controller.app.userfans.vo.AppUserFansReqVO;
import cn.iocoder.yudao.module.wine.controller.app.uservisitor.vo.*;
import cn.iocoder.yudao.module.wine.dal.dataobject.uservisitor.UserVisitorDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;

/**
 * 访客信息 Service 接口
 *
 * @author 管理员
 */
public interface UserVisitorService {

    /**
     * 添加访客信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createUserVisitor(@Valid AppUserVisitorSaveReqVO createReqVO);

    /**
     * 更新访客信息
     *
     * @param updateReqVO 更新信息
     */
    void updateUserVisitor(@Valid AppUserVisitorSaveReqVO updateReqVO);

    /**
     * 删除访客信息
     *
     * @param id 编号
     */
    void deleteUserVisitor(Long id);

    /**
     * 获得访客信息
     *
     * @param id 编号
     * @return 访客信息
     */
    UserVisitorDO getUserVisitor(Long id);

    /**
     * 获得访客信息分页
     *
     * @param pageReqVO 分页查询
     * @return 访客信息分页
     */
    PageResult<UserVisitorDO> getUserVisitorPage(AppUserVisitorPageReqVO pageReqVO);

    /**
     * 获得访客信息分页
     * @return
     */
    List<AppUserVisitorListRespVO> getUserVisitorList(AppUserFansReqVO reqVO);


    /**
     * 添加访客记录
     *
     * @param userVisitorDO 访客信息
     * @return
     */
    void addUserVisitorRecord(UserVisitorDO userVisitorDO);

    /**
     * 获取访客数量
     * @param id
     * @return
     */
    Long getVisitorNum(Long id);
}
